home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / grafica / amhelios / readme.txt < prev    next >
Text File  |  1999-01-01  |  16KB  |  443 lines
  1.              ************************************************
  2.              *** Welcome to the HELIOS Radiosity Renderer ***
  3.              ************************************************
  4.  
  5. Version:        1.03A
  6. Release Date:   96/04/01
  7.  
  8.  
  9. 1.  Introduction
  10.  
  11. Radiosity is an advanced computer graphics technique that you can use to 
  12. synthesize photorealistic images without ray tracing. HELIOS brings this 
  13. new and exciting technology to your personal desktop computer. 
  14.  
  15. Included with this release is the full C++ source code for four separate 
  16. versions of HELIOS. The code is derived from that presented in the book: 
  17.  
  18.   Ashdown, I. 1994. "Radiosity: A Programmer's Perspective," New York,
  19.   NY: John Wiley & Sons, Inc.
  20.  
  21. (See Section 6, "Read This Book!" for further details.)
  22.  
  23. The source code is included for those programmers interested in 
  24. experimenting with radiosity methods as an alternative to ray tracing 
  25. techniques. It may be freely copied, redistributed, and/or modified for 
  26. personal, non-commercial use ONLY, provided the copyright notice is 
  27. included with all source code files. 
  28.  
  29.  
  30. 2.  What is Radiosity?
  31.  
  32. There are two approaches to generating photorealistic images -- digital 
  33. pictures that are difficult to distinguish from real photographs -- in 
  34. computer graphics. The first approach involves ray-tracing techniques; 
  35. the second approach is radiosity. 
  36.  
  37. Radiosity is in a sense the complement of ray tracing. Ray-tracing 
  38. techniques excel in the rendition of point light sources, specular 
  39. reflections, and refraction effects. Radiosity methods accurately model 
  40. area light sources, diffuse reflections, color bleeding effects, and 
  41. realistic shadows. Whether you choose ray tracing or radiosity will 
  42. depend in part on what effects you consider to be more important in your 
  43. images. 
  44.  
  45. Radiosity has the advantage of view independence. Using ray-tracing 
  46. techniques, the number of ray-surface intersection calculations can 
  47. increase geometrically with the complexity of the scene. Change your 
  48. point of view and you typically have to start from scratch to generate a 
  49. new image. With radiosity, however, you only need to perform the lighting 
  50. calculations once for a given environment. Once they have been completed, 
  51. you can quickly render a view of the environment as seen from any 
  52. position and orientation. 
  53.  
  54. Folklore has it that you need a high-powered graphics workstation or even 
  55. a supercomputer to experiment with radiosity rendering techniques. Not 
  56. so! All you need is an IBM PC-AT clone with an 80386 CPU and a math 
  57. coprocessor, 4 megabytes of RAM, and a 256-color video display adapter. 
  58.  
  59. Of course, a faster machine is always better. Using an off-the-shelf 
  60. desktop computer with a 66-MHz 80486 CPU, you can create photorealistic 
  61. images in ... are you ready for this? ... less than a minute. Compared to 
  62. the hours typically needed to ray trace photorealistic images, there is 
  63. something to be said for radiosity techniques. 
  64.  
  65. To see what HELIOS is capable of, take a look at the demonstration images 
  66. DEMO_256.BMP (256 colors) or DEMO_16M.BMP (24-bit color). 
  67.  
  68.  
  69. 3.  Using HELIOS
  70.  
  71. HELIOS is a Microsoft Windows program that has the following hardware and 
  72. software requirements: 
  73.  
  74.   *  An IBM PC-AT clone with an 80386 CPU and a math coprocessor (an 
  75.      80486 or Pentium CPU is recommended. 
  76.   *  A color video display capable of displaying at least 256 colors. 
  77.   *  Microsoft Windows 3.1 or Windows 95.
  78.  
  79. Unlike many MS-Windows programs, you do *not* need to modify any system 
  80. files (such as WIN.INI or AUTOEXEC.BAT) in order to run HELIOS, nor do 
  81. you have to install anything. In fact, all you have to do is to store the 
  82. following files in the same directory on your hard disk or a floppy 
  83. diskette: 
  84.  
  85.   APPLE.ENT
  86.   CEILING.ENT
  87.   CHAIR.ENT
  88.   FLOOR.ENT
  89.   HELIOS.EXE
  90.   HELIOS.HLP
  91.   LIGHT_1.ENT
  92.   LIGHT_2.ENT
  93.   PICTURE.ENT
  94.   ROOM.WLD
  95.   SPHERE.ENT
  96.   WALL.ENT
  97.  
  98. The ROOM.WLD and *.ENT files describe a sample environment that consists
  99. of a room with a chair on the floor, a floating apple and an oblate
  100. sphere, a picture on the wall, and two fluorescent lighting fixtures
  101. that illuminate the room.
  102.  
  103. While this room may not be the most exciting of environments, it clearly
  104. demonstrates radiosity's ability to model area light sources, diffuse
  105. reflections, color bleeding effects and realistic shadows.
  106.  
  107. Assuming you have stored the files on a floppy diskette: 
  108.  
  109.   1. Insert the diskette into your floppy disk drive. 
  110.   2. Start Microsoft Windows.
  111.   3. Choose File from the Program Manager menu bar.
  112.   4. Select the Run... menu item.
  113.   5. Enter A:HELIOS.EXE in the Command Line edit control. (Substitute the 
  114.      drive letter of your floppy disk drive if necessary.) 
  115.   6. Press the <Enter> key or select the OK button.
  116.  
  117. To run HELIOS from the directory C:\HELIOS on your hard disk: 
  118.  
  119.   1. Start Microsoft Windows.
  120.   2. Choose File from the Program Manager menu bar.
  121.   3. Select the Run... menu item.
  122.   4. Enter C:\HELIOS\HELIOS.EXE in the Command Line edit control. 
  123.      (Substitute another directory name if necessary.) 
  124.   5. Press the <Enter> key or select the OK button.
  125.  
  126. Once HELIOS is up and running, you can: 
  127.  
  128.   1. Choose Help from the HELIOS Radiosity Renderer menu bar.
  129.   2. Select the Contents menu item.
  130.   3. Select the Using HELIOS topic to view instructions on how to use 
  131.      HELIOS.
  132.  
  133. The Using HELIOS topic provides a brief but complete tutorial on how to 
  134. render the demonstration room in full color and view it from any angle.
  135.  
  136.  
  137. 4.  Four Versions of HELIOS?
  138.  
  139. There are four versions of HELIOS included with this release: 
  140.  
  141.   HELIOS_C.EXE          Cubic tetrahedron
  142.   HELIOS_H.EXE          Hemicube
  143.   HELIOS_R.EXE          Ray casting
  144.   HELIOS_S.EXE          Shading only
  145.  
  146. These executables can be found in the BIN subdirectory (see Section 6, 
  147. "Release Contents"), and can directly replace HELIOS.EXE in the root 
  148. directory. 
  149.  
  150. 4.1 HELIOS_H.EXE - Hemicube
  151.  
  152.      This version is based on the progressive radiosity method. It uses 
  153.      the hemicube method to determine form factors. 
  154.  
  155. 4.2 HELIOS_C.EXE - Cubic Tetrahedron
  156.  
  157.     This version is also based on the progressive radiosity method. 
  158.     However, it uses the cubic tetrahedron method to determine form 
  159.     factors. Cubic tetrahedrons result in faster execution times (about 
  160.     25 percent or so) and fewer form-factor aliasing artifacts than do 
  161.     hemicubes.
  162.  
  163.     The program HELIOS.EXE in the root directory is really HELIOS_C.EXE. 
  164.     The only difference is that the version number in the "About HELIOS" 
  165.     dialog box has been modified to read "1.03A" instead of "1.03A/CT."
  166.  
  167. 4.3 HELIOS_R.EXE - Ray Casting
  168.  
  169.     This version uses ray casting techniques to determine its form 
  170.     factors. It does not employ BSP or any other polygon culling 
  171.     techniques, however, and so it is quite slow in comparison to 
  172.     HELIOS_C.EXE and HELIOS_H.EXE. 
  173.  
  174. 4.4 HELIOS_S.EXE - Shading Only
  175.  
  176.     This version is *not* a radiosity renderer. Rather, it implements the 
  177.     three-dimensional viewing system, polygon rendering, user interface 
  178.     and other feature needed to implement a fully-functional radiosity 
  179.     renderer. It is only capable of displaying flat-shaded polygons. 
  180.  
  181. All of the C++ source code and support files for these programs has been 
  182. included in this release of HELIOS, as itemized in the next section. See 
  183. Section 6, "Read This Book!" for further information. 
  184.  
  185.  
  186. 5.  Release Contents
  187.  
  188. The complete set of files included with this release consists of: 
  189.  
  190. 5.1 Root Directory
  191.  
  192.     HELIOS.HLP      HELIOS V1.03A on-line help file
  193.     HELIOS.EXE      HELIOS V1.03A MS-Windows 3.1 executable
  194.  
  195.     ROOM.WLD        Demonstration room environment file
  196.  
  197.     APPLE.ENT       Demonstration room entity files
  198.     CEILING.ENT
  199.     CHAIR.ENT
  200.     FLOOR.ENT
  201.     LIGHT_1.ENT
  202.     LIGHT_2.ENT
  203.     PICTURE.ENT
  204.     SPHERE.ENT
  205.     WALL.ENT
  206.  
  207.     README.TXT      This file
  208.  
  209.     [BC45]          Borland C++ Version 4.5 subdirectory
  210.     [BIN]           Binary executables subdirectory
  211.     [HELP]          Help files subdirectory
  212.     [INCLUDE]       HELIOS C++ include files subdirectory
  213.     [MSVC]          Microsoft C++ Version 1.5 subdirectory
  214.     [SOURCE]        HELIOS C++ source code files subdirectory
  215.  
  216. 5.2 Subdirectory BC45
  217.  
  218.     [CUBIC]         HELIOS V1.03A/CT IDE file subdirectory
  219.     [HEMI]          HELIOS V1.03A/HC IDE file subdirectory
  220.     [RAY]           HELIOS V1.03A/RC IDE file subdirectory
  221.     [SHADE]         HELIOS V1.03A/SH IDE file subdirectory
  222.  
  223. 5.3 Subdirectory BC45\CUBIC
  224.  
  225.     HELIOS_C.IDE    Borland C++ IDE file for HELIOS V1.03A/CT 
  226.  
  227. 5.4 Subdirectory BC45\HEMI
  228.  
  229.     HELIOS_H.IDE    Borland C++ IDE file for HELIOS V1.03A/HC
  230.  
  231. 5.5 Subdirectory BC45\RAY
  232.  
  233.     HELIOS_R.IDE    Borland C++ IDE file for HELIOS V1.03A/RC 
  234.  
  235. 5.6 Subdirectory BC45\SHADE
  236.  
  237.     HELIOS_S.IDE    Borland C++ IDE file for HELIOS V1.03A/SH
  238.  
  239. 5.7 Subdirectory BIN
  240.  
  241.     HELIOS_C.EXE    HELIOS Version 1.03A/CT executable
  242.     HELIOS_H.EXE    HELIOS Version 1.03A/HC executable
  243.     HELIOS_R.EXE    HELIOS Version 1.03A/RC executable
  244.     HELIOS_S.EXE    HELIOS Version 1.03A/SH executable
  245.  
  246. 5.8 Subdirectory DEMO
  247.  
  248.     APPLE.ENT       Demonstration room entity files
  249.     CEILING.ENT
  250.     CHAIR.ENT
  251.     FLOOR.ENT
  252.     LIGHT_1.ENT
  253.     LIGHT_2.ENT
  254.     PICTURE.ENT
  255.     SPHERE.ENT
  256.     WALL.ENT
  257.  
  258.     ROOM.WLD        Demonstration room environment file
  259.  
  260. 5.9 Subdirectory HELP
  261.  
  262.     GLOSSARY.RTF    HELIOS help file glossary (Rich Text Format)
  263.     HELIOS.HPJ      HELIOS help project file
  264.     HELIOS.HLP      HELIOS help file
  265.     HELIOS.RTF      HELIOS help file master (Rich Text Format)
  266.     WIN_HELP.H      HELIOS help include file
  267.  
  268. 5.10 Subdirectory INCLUDE    HELIOS C++ include files
  269.  
  270.     COLOR.H         Colors
  271.     CT_CLIP.H       Cubic tetrahedron element clipping
  272.     CT_DELTA.H      Cubic tetrahedron form factor deltas
  273.     CT_POLY.H       Cubic tetrahedron elements
  274.     CT_SCAN.H       Cubic tetrahedron element scanning
  275.     CUBIC_T.H       Cubic tetrahedrons
  276.     C_JITTER.H      Color jittering
  277.     ENVIRON.H       Environment
  278.     ERROR.H         Error reporting
  279.     FF_CLIP.H       Form factor element clipping
  280.     FF_DELTA.H      Form factor deltas
  281.     FF_POLY.H       Form factor elements
  282.     FF_SCAN.H       Form factor element scanning
  283.     GAMMA.H         Gamma correction
  284.     GENERAL.H       General
  285.     HC_CLIP.H       Hemicube element clipping
  286.     HC_DELTA.H      Hemicube form factor deltas
  287.     HC_POLY.H       Hemicube elements
  288.     HC_SCAN.H       Hemicube element scanning
  289.     HELIOS.H        HELIOS MS-Windows interface
  290.     HEMICUBE.H      Hemicubes
  291.     INSTANCE.H      Instances
  292.     OCT_QUAN.H      Octree color quantization
  293.     OUT_POLY.H      Polygon output
  294.     PARSE.H         Input file parser
  295.     PATCH3.H        3D patches
  296.     PROG_RAD.H      Progressive radiosity
  297.     P_CLIP4.H       Homogeneous polygon clipping
  298.     P_RENDER.H      Polygon rendering
  299.     RAD_EQN.H       Radiosity equation solver
  300.     RAY_CAST.H      Ray casting
  301.     RAY_RAD.H       Ray-cast radiosity
  302.     RESOURCE.H      HELIOS resource file
  303.     SURFACE3.H      3D surfaces
  304.     SYN_CAM.H       Synthetic camera
  305.     TRANSFM3.H      3D transformations
  306.     VECTOR3.H       3D vectors
  307.     VECTOR4.H       Homogeneous vectors
  308.     VERTEX4.H       Homgeneous vertices
  309.     VIEW_SYS.H      Viewing system
  310.     WIN_BMAP.H      MS-Windows BMP (bitmap) files
  311.     WIN_META.H      MS-Windows metafiles
  312.     WIN_SBAR.H      Scroll bars
  313.     WIN_TEXT.H      MS-Windows text manager
  314.     WIN_TGA.H       Targa (TGA) files
  315.  
  316. 5.11 Subdirectory MSVC
  317.  
  318.     [CUBIC]         HELIOS V1.03A/CT MAKE file subdirectory
  319.     [HEMI]          HELIOS V1.03A/HC MAKE file subdirectory
  320.     [RAY]           HELIOS V1.03A/RC MAKE file subdirectory
  321.     [SHADE]         HELIOS V1.03A/SH MAKE file subdirectory
  322.  
  323. 5.12 Subdirectory MSVC\CUBIC
  324.  
  325.     HELIOS_C.MAK    Microsoft C++ MAK file for HELIOS V1.03A/CT 
  326.  
  327. 5.13 Subdirectory MSVC\HEMI
  328.  
  329.     HELIOS_H.MAK    Microsoft C++ MAK file for HELIOS V1.03A/HC
  330.  
  331. 5.14 Subdirectory MSVC\RAY
  332.  
  333.     HELIOS_R.MAK    Microsoft C++ MAK file for HELIOS V1.03A/RC 
  334.  
  335. 5.15 Subdirectory MSVC\SHADE
  336.  
  337.     HELIOS_S.MAK    Microsoft C++ MAK file for HELIOS V1.03A/SH
  338.  
  339. 5.16 Subdirectory SOURCE     HELIOS C++ source code files
  340.  
  341.     CT_CLIP.CPP     Cubic tetrahedron element clipping
  342.     CT_DELTA.CPP    Cubic tetrahedron form factor deltas
  343.     CT_SCAN.CPP     Cubic tetrahedron element scanning
  344.     CUBIC_T.CPP     Cubic tetrahedrons
  345.     C_JITTER.CPP    Color jittering
  346.     ENVIRON.CPP     Environment
  347.     ERROR.CPP       Error reporting
  348.     FF_CLIP.CPP     Form factor element clipping
  349.     FF_SCAN.CPP     Form factor element scanning
  350.     GAMMA.CPP       Gamma correction
  351.     HC_CLIP.CPP     Hemicube element clipping
  352.     HC_DELTA.CPP    Hemicube form factor deltas
  353.     HC_SCAN.CPP     Hemicube element scanning
  354.     HELIOS.DEF      HELIOS definition file
  355.     HELIOS.RC       HELIOS resource file
  356.     HELIOS.CPP      HELIOS MS-Windows interface
  357.     HELIOS_C.ICO    HELIOS V1.03A/CT icon
  358.     HELIOS_H.ICO    HELIOS V1.03A/HC icon
  359.     HELIOS_R.ICO    HELIOS V1.03A/RC icon
  360.     HELIOS_S.ICO    HELIOS V1.03A/SH icon
  361.     HEMICUBE.CPP    Hemicubes
  362.     OCT_QUAN.CPP    Octree color quantization
  363.     PARSE.CPP       Input file parser
  364.     PATCH3.CPP      3D patches
  365.     PROG_RAD.CPP    Progressive radiosity
  366.     P_CLIP4.CPP     Homogeneous polygon clipping
  367.     P_RENDER.CPP    Polygon rendering
  368.     RAD_EQN.CPP     Radiosity equation solver
  369.     RAD_TMP.CPP     Dummy radiosity equation solver
  370.     RAY_CAST.CPP    Ray casting
  371.     RAY_RAD.CPP     Ray-cast radiosity
  372.     SYN_CAM.CPP     Synthetic camera
  373.     TEST_1.CPP      Development test program #1
  374.     TEST_2.CPP      Development test program #2
  375.     TEST_3.CPP      Development test program #3
  376.     TEST_4.CPP      Development test program #4
  377.     VECTOR3.CPP     3D vectors
  378.     VIEW_SYS.CPP    Viewing system
  379.     WIN_BMAP.CPP    MS-Windows BMP (bitmap) files
  380.     WIN_HELP.H      Online help include file
  381.     WIN_SBAR.CPP    Scroll bars
  382.     WIN_TGA.CPP     Targa (TGA) files
  383.  
  384.  
  385. 6.  Read This Book!
  386.  
  387. The C++ source code included with this release of HELIOS is fully 
  388. commented. However, it is often difficult to understand the inner 
  389. workings of a program from the source code comments alone, no matter how 
  390. well-written they may be. 
  391.  
  392. In the case of HELIOS, however, the radiosity-related code has been 
  393. fully documented. To obtain a copy of this documentation, you can (ahem) 
  394. buy: 
  395.  
  396.   Radiosity: A Programmer's Perspective
  397.  
  398.               by Ian Ashdown
  399.  
  400.   Published by John Wiley & Sons, Inc., New York, NY
  401.   Paperback, 498 pages with 12 color plates, 1994
  402.  
  403.   ISBN 0-471-30444-1 (without diskette), $39.95 US
  404.   ISBN 0-471-30488-3 (with 3.5-inch MS-DOS diskette), $54.95 US
  405.  
  406. To order a copy of this book, you can call 1-800-CALL-WILEY in the
  407. United States and Canada. You can also order it online from Wiley's Web 
  408. page (http://www.wiley.com). 
  409.  
  410. "Radiosity: A Programmer's Perspective" offers step-by-step guidance for 
  411. the development of a fully functional, radiosity-based rendering program 
  412. for Microsoft Windows and other graphical environments, including: 
  413.  
  414.   *  A detailed explanation of radiosity theory and its associated 
  415.      algorithms (no knowledge of higher mathematics required!)
  416.   *  Complete, fully documented, and compiler-independent C++ source code 
  417.      for HELIOS, a radiosity renderer for Microsoft Windows 3.1, Windows
  418.      95, and Windows NT (tm).
  419.   *  An extensive guide to the computer graphics radiosity literature.
  420.  
  421. (The version of HELIOS presented in the book employs a simplified user 
  422. interface, due to lack of space for the source code. The radiosity-
  423. related code, however, is identical to that included with this release of 
  424. HELIOS.) 
  425.  
  426.  
  427. 7.  Credits
  428.  
  429. HELIOS was written by:
  430.  
  431.   byHeart Software Limited
  432.   620 Ballantree Road
  433.   West Vancouver, B.C.
  434.   Canada V7S 1W3
  435.  
  436.   Attn: Ian Ashdown, President
  437.  
  438.   Web URL:      http://www.ledalite.com
  439.   e-mail:       iashdown@ledalite.com
  440.  
  441. Comments and questions are welcome.
  442.  
  443.